package com.sws.attendance.mapper;

import java.util.Date;
import java.util.List;
import com.sws.attendance.domain.StuAttendance;
import org.apache.ibatis.annotations.*;

/**
 * 学生签到记录Mapper接口
 * 
 * @author cx
 * @date 2025-06-16
 */
@Mapper
public interface StuAttendanceMapper
{
    /**
     * 查询学生签到记录
     * 
     * @param id 学生签到记录主键
     * @return 学生签到记录
     */
    public StuAttendance selectStuAttendanceById(Long id);

    /**
     * 查询学生签到记录列表
     * 
     * @param stuAttendance 学生签到记录
     * @return 学生签到记录集合
     */
    public List<StuAttendance> selectStuAttendanceList(StuAttendance stuAttendance);

    /**
     * 新增学生签到记录
     * 
     * @param stuAttendance 学生签到记录
     * @return 结果
     */
    public int insertStuAttendance(StuAttendance stuAttendance);

    /**
     * 修改学生签到记录
     * 
     * @param stuAttendance 学生签到记录
     * @return 结果
     */
    public int updateStuAttendance(StuAttendance stuAttendance);

    /**
     * 删除学生签到记录
     * 
     * @param id 学生签到记录主键
     * @return 结果
     */
    public int deleteStuAttendanceById(Long id);

    /**
     * 批量删除学生签到记录
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteStuAttendanceByIds(Long[] ids);

    /**
     * 根据学生的pid和记录日期，确定学生当天打卡记录是否存在
     * @param pid 学生ID
     * @param recordDate 记录日期
     * @return 学生考勤记录
     */
    StuAttendance selectStuAttendanceByPidAndRecordDate(
            @Param("pid") String pid,
            @Param("recordDate") Date recordDate
    );

    /**
     * 逻辑删除学生签到记录
     *
     * @param id 学生签到记录主键
     * @return 结果
     */
    int updateDelFlagById(Long id);

    /**
     * 批量逻辑删除学生签到记录
     *
     * @param ids 需要删除的学生签到记录主键
     * @return 结果
     */
    int updateDelFlagByIds(Long[] ids);

    /**
 * 学生签到记录Mapper接口
 * 
 * @author cx
 * @date 2025-06-16
 */

    @Update("UPDATE stu_attendance SET del_flag = 1 WHERE pid = '未识别出' AND del_flag = 0")
    int logicalDeleteUnrecognizedAttendances();

    /**
     * 物理删除已被标记为逻辑删除的考勤记录
     *
     * @return 删除的记录数
     */
    @Delete("DELETE FROM stu_attendance WHERE del_flag = 1")
    int physicalDeleteLogicalDeletedAttendances();

}

